Skip to content

feat(preset): add nexusx-4phase speckit preset#81

Closed
allmonday wants to merge 1 commit into
masterfrom
feat/speckit-preset-nexusx-4phase
Closed

feat(preset): add nexusx-4phase speckit preset#81
allmonday wants to merge 1 commit into
masterfrom
feat/speckit-preset-nexusx-4phase

Conversation

@allmonday

Copy link
Copy Markdown
Collaborator

Summary

  • 新增 speckit-preset/:把 nexusx 四阶段 V 型工作流(Schema → Loader → UseCase+MCP → SDK)分层叠加到 spec-kit 的 specify → plan → tasks → implement pipeline 上
  • 通过 speckit preset 的 composition 策略(append / wrap / replace)注入 Phase 语义,保留 spec-kit 原生 workflow
  • 包含 scaffold/(models + db + main + service//)作为项目骨架参考

What's in the preset

4 document templates

Template Strategy Effect
spec-template append Phase 0 八步需求确认(entities / relationships / aggregate roots / service split / DB 策略)
plan-template append Phase 1 SQLModel / Relationship / Voyager / alembic 决策
phase-template new 每 Phase 的 V降 / 实现 / V升 三段 spec
checklist-template replace V 型验收清单 + spec/ 目录完整性检查

5 command templates

Command Strategy Effect
speckit.specify wrap 注入 Phase 0 八步确认
speckit.plan wrap 注入 Phase 1 schema/ER/DB 决策
speckit.tasks wrap 按 Phase 2/3/4 分组任务
speckit.implement wrap 每 Phase 跑 V 型循环 + gate
speckit.nexusx.phase new 进入指定 Phase (0/1/2/3/4)

Install

specify preset add --dev ./speckit-preset
specify preset resolve spec-template    # 验证 core + nexusx 叠加
specify preset resolve plan-template

Status

MVP — preset manifest 验证通过,模板 composition 正常。已知待办(看后续 follow-up):

  • 本项目 ai_skills: true 模式下,commands 不会自动渲染到 .claude/commands/;要么切到 commands 模式,要么手工补一份 .claude/skills/<name>/SKILL.md
  • 当前 preset 把 Phase 0-4 内容一次性 bake 进顶层命令,未走 MCP 那种渐进披露(list_apps → describe_compose_schema → describe_compose_method → compose_query)。后续可改成 Layer 0/1/2/3 按需加载,避免顶层命令臃肿

Test plan

  • specify preset add --dev ./speckit-preset 安装成功
  • specify preset info nexusx-4phase 显示 9 templates(4 doc + 5 cmd)
  • specify preset resolve spec-template 显示 core → nexusx-4phase 两层 composition
  • specify preset resolve plan-template 同上
  • 在 commands 模式的项目里跑一遍 /speckit-specify 验证 wrap 注入符合预期
  • 端到端跑一个新 feature 验证 V 型循环

🤖 Generated with Claude Code

Layer the 4-phase V-model workflow (Schema → Loader → UseCase+MCP → SDK) on
top of spec-kit's specify → plan → tasks → implement pipeline.

- spec-template (append): Phase 0 8-step requirements confirmation
- plan-template (append): Phase 1 schema/ER/DB + alembic decisions
- phase-template (new): per-phase V降/实现/V升 spec
- checklist-template (replace): V-model acceptance + spec/ completeness
- speckit.{specify,plan,tasks,implement} (wrap): inject phase semantics
- speckit.nexusx.phase (new): enter a specific phase explicitly
- scaffold/: code skeleton (models/db/main + service/<domain>/) from skill/

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@allmonday allmonday closed this Jul 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant